package com.jl15988.simpletools.appcore.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.jl15988.simpletools.appcore.dto.AppQueryDTO;
import com.jl15988.simpletools.appcore.entity.App;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 应用Mapper接口
 *
 * @author jl15988
 */
@Mapper
public interface AppMapper extends BaseMapper<App> {

    /**
     * 分页查询应用列表
     *
     * @param page 分页参数
     * @param query 查询条件
     * @return 分页结果
     */
    IPage<App> selectAppPage(Page<App> page, @Param("query") AppQueryDTO query);

    /**
     * 增加下载次数
     *
     * @param appId 应用ID
     * @return 影响行数
     */
    int incrementDownloads(@Param("appId") Long appId);
    
    /**
     * 获取下载总数
     *
     * @return 下载总数
     */
    long selectTotalDownloads();
    
    /**
     * 获取指定日期范围内的下载数
     *
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 下载数
     */
    long selectDownloadsByDateRange(@Param("startDate") LocalDateTime startDate, @Param("endDate") LocalDateTime endDate);
    
    /**
     * 获取下载趋势数据
     *
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @param timeRange 时间范围
     * @return 下载趋势数据
     */
    List<Map<String, Object>> selectDownloadTrend(@Param("startDate") LocalDateTime startDate, 
                                                 @Param("endDate") LocalDateTime endDate,
                                                 @Param("timeRange") String timeRange);
    
    /**
     * 获取热门应用排行
     *
     * @param limit 限制数量
     * @return 热门应用列表
     */
    List<Map<String, Object>> selectTopAppsByDownloads(@Param("limit") int limit);
} 